Today's networks are increasingly complex and installing a new application may require interaction from several operational groups in order to insure success. This section describes how MOMI communicates between the PC Client and NonStop based MOMI server.
The MOMI PC Client uses native TCP/IP (i.e. no RSC or anything like that is used) and opens a TCP socket to the MOMI Server on the NonStop platform.
Common problem scenarios are described and discussed.
MOMI uses an address and port defined by the user. Communication originates from the MOMI PC based Windows client program and is destined to a NonStop Server based process. The TCP level socket provides two-way or bi-directional communication. Multiple sockets may be used, but all are originated from the MOMI PC Client.
MOMI uses 'plain Jane' TCP/IP native to Windows and the NonStop System. No other communication software is required.
The MOMI server on the NonStop System must be started first. This allows the server to initialize and prepare to receive incoming connections.
On the NonStop server, in the subvolume where MOMI is installed the edit format file CONFMOMI contains at least one of the following lines:
== TCP/IP process and port
In this example, the line specifies that the MOMI server is listening on the TCP/IP process $ZTC0 port 2000.== the MOMI server listens
Tcpip-info-1 $ZTC0 2000
Once the MOMI Server is running, give it a couple of minutes after starting, in the MOMI PC Client, assuming that $ZTC0 has a TCP/IP address of 192.168.20.10, you would enter the following information (color highlighted) on the screen Configure / Define Systems:
If communication is successfully established, the following displays:
The pop-up window entitled "Confirm System Name" indicates communication was successfully established. If desired update the text field, showing the system name \BWS1 above, and then push Save to complete the operation of defining a system to MOMI.
The first system is successfully defined becomes the default system displayed on subsequent startups of the MOMI PC Client. The default system displayed may be changed on this screen.
Now, what can go wrong
I pressed "Add new System" and nothing happed
It can take up to 30 seconds for a response if a timeout or retries occur. Normally, after pressing "Add new System, the response from the MOMI server is immediate.
The TCP/IP process name is not valid
Shortly after starting MOMI, check the EMS log on the NonStop System. If MOMI encounters any error accessing the TCP/IP process, messages are logged to EMS.
To determine if the TCP/IP process named entered in the CONFMOMI file ($ZTC0 used in our example) is correct, from a TACL prompt enter the following command:
STATUS $ZTC0
If the process is found, several lines of data appear listing either TCPIP or TCP6SAM as the object file name (usually located in $SYSTEM.SYSnn). If the process name is not found, TACL returns "Process does not exist". Check with your NonStop System administrator to determine the correct TCP/IP stack process name. Note that multiple stacks may exist on the system (i.e. you need the correct one and not any one).
The TCP/IP port is already in use
Shortly after starting MOMI, check the EMS log on the NonStop System. If MOMI encounters any errors accessing the TCP/IP socket (i.e. port), messages are logged to EMS.
To determine if a TCP port is free, start a SCF from a TACL prompt and enter the following command:
SCF status process $ZTC0
Examine the output and find a port in the LPort column not used (greater than 1024 and less than 32767)
The TCP/IP address entered in the client is not correct
Check with the system and/or network administrator to confirm the address(es) for the TCP/IP stack.
It is possible that your network re-maps addresses. Literally, the NonStop System address may not be directly accessible, but an alternate mapped address is referenced.
The TCP/IP address and port are both correct and not already in use but I still can't connect
This may indicate a firewall and/or firewall software is in-between your MOMI PC Client and the NonStop Server. The firewall may be running on your PC and/or is a physical box on the network in-between your PC and the NonStop Server. You can try to PING from your PC to the NonStop Server by opening up a command prompt window and entering the following (using the example IP address above):
PING 192.168.20.10
Unfortunately, it is possible that the PING works but a MOMI connection fails. This would indicate that the ICMP (i.e. what a PING really is) function is allowed but MOMI data flow is not.
The best bet, assuming the required TCP/IP address and port information is valid and the MOMI server is started and successfully running on the NonStop System, is to speak with your network and/or PC administrators and determine what procedures are required to enable a new TCP/IP network application within your environment. It is very possible that both local PC and network authorization is required.
What things may stop MOMI data flow
Generally speaking, firewall and anti-virus port scanning software.
Network firewalls in-between corporate PC's and Servers are getting to be more common place. The extra level of security means that any new application must be enabled. Literally, firewalls prevent communication to non-approved network methods.
Anti-Virus port scanning software can be configured to examine all TCP/IP port traffic. The examination itself may interfere or the lack of understanding MOMI's communication protocol by the AntiVirus software can prevent or stop communication by error-ing on the side of caution.In both cases, environments running protections of this type would have a defined procedure available (i.e. forms to fill out) to establish a new software product. Since Introducing new software applications such as MOMI is probably not an everyday occurrence, don't' be surprised if the required underlying tasks need to be dug out from a drawer and 'dusted off' :)